<!DOCTYPE html>
<html lang="zh-CN">

<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="Git使用简明指南 - 帮助你快速入门Git的基本操作">
    <meta name="keywords" content="git,指南,教程,入门,简明,版本控制">
    <title>git - 简明指南 - 无需深入学习!</title>
    <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link href="https://fonts.googleapis.com/css2?family=Chelsea+Market&display=swap" rel="stylesheet">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/normalize/8.0.1/normalize.min.css">
    <link rel="stylesheet" href="css/style.css">
</head>

<body>
    <div class="scrollblock block-title">
        <h1>git - 简明指南</h1>
        <p>助你入门 git 的简明指南，木有高深内容</p>
        <p class="meta">
            作者：<a href="https://www.nutpi.net/">坚果派</a>
            <br /> 感谢：<a href="https://gitcode.com/nutpi/git-guide">罗杰·杜德勒</a>,
            <br />
            其他语言
            <a href="index.en.html">english</a>,
            <a href="index.de.html">deutsch</a>,
            <a href="index.es.html">español</a>,
            <a href="index.fr.html">français</a>,
            <a href="index.id.html">indonesian</a>,
            <a href="index.it.html">italiano</a>,
            <a href="index.nl.html">nederlands</a>,
            <a href="index.pl.html">polski</a>,
            <a href="index.pt_BR.html">português</a>,
            <a href="index.ru.html">русский</a>,
            <a href="index.tr.html">türkçe</a>,
            <br />
            <a href="index.my.html">မြန်မာ</a>,
            <a href="index.ja.html">日本語</a>,
            <a href="index.ko.html">한국어</a>
            <a href="index.vi.html">Vietnamese</a>
            <br />
            如有纰漏，请在 <a href="https://gitcode.com/nutpi/git-guide/issues">gitcode</a> 提报问题
        </p>
        <img src="img/arrow.png" alt="向下滚动箭头" />
    </div>
    <!-- setup -->
    <a name="setup"></a>
    <div class="scrollblock block-setup">
        <h2>安装</h2>
        <p>
            <a href="http://git-scm.com/download/mac">下载 git OSX 版</a>
        </p>
        <p>
            <a href="http://git-for-windows.github.io/">下载 git Windows 版</a>
        </p>
        <p>
            <a href="http://book.git-scm.com/2_installing_git.html">下载 git Linux 版</a>
        </p>
    </div>
    <a name="create"></a>
    <div class="scrollblock block-create">
        <h2>创建新仓库</h2>
        <p>
            创建新文件夹，打开，然后执行 <br />
            <code>git init</code><br />
            以创建新的 git 仓库。
        </p>
    </div>
    <a name="checkout"></a>
    <div class="scrollblock block-checkout">
        <h2>检出仓库</h2>
        <p>
            执行如下命令以创建一个本地仓库的克隆版本：<br />
            <code>git clone /path/to/repository</code> <br />
            如果是远端服务器上的仓库，你的命令会是这个样子：<br />
            <code>git clone username@host:/path/to/repository</code>
        </p>
    </div>
    <a name="trees"></a>
    <div class="scrollblock block-trees">
        <h2>工作流</h2>
        <p>
            你的本地仓库由 git 维护的三棵“树”组成。第一个是你的 <code>工作目录</code>，它持有实际文件；第二个是 <code>暂存区（Index）</code>，它像个缓存区域，临时保存你的改动；最后是
            <code>HEAD</code>，它指向你最后一次提交的结果。
        </p>
        <img src="img/trees.png" alt="" />
    </div>
    <a name="add"></a>
    <div class="scrollblock block-add">
        <h2>添加和提交</h2>
        <p>
            你可以提出更改（把它们添加到暂存区），使用如下命令：<br />
            <code>git add &lt;filename&gt;</code><br />
            <code>git add *</code><br />
            这是 git 基本工作流程的第一步；使用如下命令以实际提交改动：<br />
            <code>git commit -m "代码提交信息"</code><br />
            现在，你的改动已经提交到了 <b>HEAD</b>，但是还没到你的远端仓库。
        </p>
    </div>
    <a name="push"></a>
    <div class="scrollblock block-remote">
        <h2>推送改动</h2>
        <p>
            你的改动现在已经在本地仓库的 <b>HEAD</b> 中了。执行如下命令以将这些改动提交到远端仓库：<br />
            <code>git push origin master</code><br />
            可以把 <i>master</i> 换成你想要推送的任何分支。
            <br /><br />
            如果你还没有克隆现有仓库，并欲将你的仓库连接到某个远程服务器，你可以使用如下命令添加：<br />
            <code>git remote add origin &lt;server&gt;</code><br />
            如此你就能够将你的改动推送到所添加的服务器上去了。<br />

        </p>
    </div>
    <a name="branching"></a>
    <div class="scrollblock block-branching">
        <h2>分支</h2>
        <p>
            分支是用来将特性开发绝缘开来的。在你创建仓库的时候，<i>master</i> 是“默认的”分支。在其他分支上进行开发，完成后再将它们合并到主分支上。
        </p>
        <img src="img/branches.png" alt="" />
        <p>
            创建一个叫做“feature_x”的分支，并切换过去：<br />
            <code>git checkout -b feature_x</code><br />
            切换回主分支：<br />
            <code>git checkout master</code><br />
            再把新建的分支删掉：<br />
            <code>git branch -d feature_x</code><br />
            除非你将分支推送到远端仓库，不然该分支就是 <i>不为他人所见的</i>：<br />
            <code>git push origin &lt;branch&gt;</code>
        </p>
    </div>
    <a name="update"></a>
    <div class="scrollblock block-merging">
        <h2>更新与合并</h2>
        <p>
            要更新你的本地仓库至最新改动，执行：<br />
            <code>git pull</code><br />
            以在你的工作目录中 <i>获取（fetch）</i> 并 <i>合并（merge）</i> 远端的改动。<br />
            要合并其他分支到你的当前分支（例如 master），执行：<br />
            <code>git merge &lt;branch&gt;</code><br />
            在这两种情况下，git 都会尝试去自动合并改动。遗憾的是，这可能并非每次都成功，并可能出现<i>冲突（conflicts）</i>。
            这时候就需要你修改这些文件来手动合并这些<i>冲突（conflicts）</i>。改完之后，你需要执行如下命令以将它们标记为合并成功：<br />
            <code>git add &lt;filename&gt;</code><br />
            在合并改动之前，你可以使用如下命令预览差异：<br />
            <code>git diff &lt;source_branch&gt; &lt;target_branch&gt;</code>
        </p>
    </div>
    <a name="tagging"></a>
    <div class="scrollblock block-tagging">
        <h2>标签</h2>
        <p>
            为软件发布创建标签是推荐的。这个概念早已存在，在 SVN 中也有。你可以执行如下命令创建一个叫做 <i>1.0.0</i> 的标签：<br />
            <code>git tag 1.0.0 1b2e1d63ff</code><br />
            <i>1b2e1d63ff</i> 是你想要标记的提交 ID 的前 10 位字符。可以使用下列命令获取提交 ID：<br />
            <code>git log</code><br />
            你也可以使用少一点的提交 ID 前几位，只要它的指向具有唯一性。
        </p>
    </div>
    <a name="log"></a>
    <div class="scrollblock block-log">
        <h2>log</h2>
        <p>
            如果你想了解本地仓库的历史记录，最简单的命令就是使用: <br />
            <code>git log</code><br />
            你可以添加一些参数来修改他的输出，从而得到自己想要的结果。 只看某一个人的提交记录:<br />
            <code>git log --author=bob</code><br />
            一个压缩后的每一条提交记录只占一行的输出:<br />
            <code>git log --pretty=oneline</code><br />
            或者你想通过 ASCII 艺术的树形结构来展示所有的分支, 每个分支都标示了他的名字和标签: <br />
            <code>git log --graph --oneline --decorate --all</code><br />
            看看哪些文件改变了: <br />
            <code>git log --name-status</code><br />
            这些只是你可以使用的参数中很小的一部分。更多的信息，参考：<br />
            <code>git log --help</code><br />
        </p>
    </div>
    <a name="checkout-replace"></a>
    <div class="scrollblock block-checkout-replace">
        <h2>替换本地改动</h2>
        <p>
            假如你操作失误（当然，这最好永远不要发生），你可以使用如下命令替换掉本地改动：<br />
            <code>git checkout -- &lt;filename&gt;</code><br />
            此命令会使用 HEAD 中的最新内容替换掉你的工作目录中的文件。已添加到暂存区的改动以及新文件都不会受到影响。
        </p>
        <p>
            假如你想丢弃你在本地的所有改动与提交，可以到服务器上获取最新的版本历史，并将你本地主分支指向它：<br />
            <code>git fetch origin</code><br />
            <code>git reset --hard origin/master</code>
        </p>
    </div>
    <a name="hints"></a>
    <div class="scrollblock block-hints">
        <h2>实用小贴士</h2>
        <p>
            内建的图形化 git：<br />
            <code>gitk</code><br />
            彩色的 git 输出：<br />
            <code>git config color.ui true</code><br />
            显示历史记录时，每个提交的信息只显示一行：<br />
            <code>git config format.pretty oneline</code><br />
            交互式添加文件到暂存区：<br />
            <code>git add -i</code>
        </p>
    </div>
    <a name="resources"></a>
    <div class="scrollblock block-resources">
        <h2>链接与资源</h2>
        <h3>图形化客户端</h3>
        <p>
        <ul>
            <li><a href="http://gitx.laullon.com/">GitX (L) (OSX, 开源软件)</a></li>
            <li><a href="http://www.git-tower.com/">Tower (OSX)</a></li>
            <li><a href="http://www.sourcetreeapp.com/">Source Tree (OSX, 免费)</a></li>
            <li><a href="http://mac.github.com/">GitHub for Mac (OSX, 免费)</a></li>
            <li><a href="https://itunes.apple.com/gb/app/gitbox/id403388357?mt=12">GitBox (OSX, App Store)</a></li>
        </ul>
        </p>
        <h3>指南和手册</h3>
        <p>
        <ul>
            <li><a href="http://book.git-scm.com/">Git 社区参考书</a></li>
            <li><a href="http://progit.org/book/">专业 Git</a></li>
            <li><a href="http://think-like-a-git.net/">像 git 那样思考</a></li>
            <li><a href="http://help.github.com/">GitHub 帮助</a></li>
            <li><a href="http://marklodato.github.io/visual-git-guide/index-zh-cn.html">图解 Git</a></li>
        </ul>
        </p>
    </div>


    <a href="http://www.git-tower.com/?source=rd"
        onClick="recordOutboundLink(this, 'Outbound Links', 'git-tower.com');return false;" class="tower"></a>
    <a href="files/git_cheat_sheet.pdf" onClick="recordOutboundLink(this, 'Cheat Sheet', 'git-guide');return false;"
        class="cheatsheet"></a>
</body>

</html>